home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: MegaDisc / MegaDisc 43 (1995-03)(MegaDisc Digital Publishing)(AU)(Disk 2 of 2)[m bamcopy].zip / MegaDisc 43 (1995-03)(MegaDisc Digital Publishing)(AU)(Disk 2 of 2)[m bamcopy].adf / Virus / Virus_Checker.Doc / Virus_Checker.Doc
Text File  |  1995-03-16  |  35KB  |  828 lines
  1. ›1m                         Virus_Checker.guide›0m
  2. Author "John Veldthuis"
  3.  
  4.  
  5. ›1mVirus_Checker documentation›0m
  6. ************************************************************************
  7.  
  8.             Virus_Checker Documentation
  9.  
  10.                  by John Veldthuis
  11.               Member of SHI Anti Virus Group 
  12.  
  13. ************************************************************************
  14.  
  15.  
  16.               ›3m Distribution                        ›0m
  17.                       ›3m PGP Signatures                      ›0m
  18.                       ›3m SHAREWARE                           ›0m
  19.                       ›3m Unpack.library                      ›0m
  20.                       ›3m xfdmaster.library                   ›0m
  21.               ›3m About Safe Hex International        ›0m
  22.               ›3m Setting Up Virus_Checker            ›0m
  23.                       ›3m BrainFile for VirusChecker          ›0m
  24.               ›3m Documentation for French Users      ›0m
  25.               ›3m Virus_Checker Version Notes         ›0m
  26.                       ›3m MakeKey program                     ›0m
  27.               ›3m Viruses Virus_Checker Deals With:   ›0m
  28.               ›3m Credits                             ›0m
  29.  
  30. ************************************************************************
  31.  
  32.  
  33.  
  34. ›1m   PGP Sigs   ›0m
  35. PGP Sigs:
  36.  
  37. As from version 6.44 all Virus_Checker releases will have PGP sigs attached
  38. to them. This enables an extra check to ensure that the file is intact.
  39.  
  40.    Below you will find my signed public key.  Save it to a disk file and
  41. enter `PGP <file name>' to decode it.  This will produce a file called
  42. `public_key'.  To add my key to your PGP keyring now enter `PGP -ka
  43. public_key' and follow the instructions on the screen.  To verify my
  44. signature, now enter `PGP <file name>' again.  It's probably pretty
  45. paranoid to rely upon PGP signatures and keys, but then again you might
  46. want to have a somewhat unambiguous proof that the distribution archives
  47. you have downloaded are intact.  Security can still be compromised, it you
  48. don't trust the key below you can still contact me to ask for an official
  49. key.
  50.  
  51. To check that the signature matches the file simply do
  52. PGP <filename>.sig <filename>
  53. PGP will warn you if the signature does not match the file.
  54.  
  55. -----BEGIN PGP PUBLIC KEY BLOCK-----
  56. Version: 2.6ui (Amiga)
  57.  
  58. mQCNAi6h70wAAAEEANWu8csrvc6Z/JY21kiJwklSIDVltJKlxNGU47AFrIGUTcSD
  59. 12WNXFKSn/wdjVLJ6ATgRBeErtxPj8t9p7ple4/cN8uziYzC0gFbQdfH/CmcrM0e
  60. sPQJxcmkUiFG7BpENF9uqS2hNyL1HL4xHOwFXcN1PUZflGxtaQ0mtYy7jZfBAAUR
  61. tCpKb2huIFZlbGR0aHVpcyA8am9obnZAdG93ZXIuYWN0cml4Lmdlbi5uej6JAJUC
  62. BRAuskv2oNrznbERpEEBAS2qA/9GpqEYN43g7kDZbWN8kxlFPhcIuDRRnZquLu/k
  63. dCyPMW0ZQ6SNWp+1+1J/MNdPVVmRvzxacsnAmeKFDGfWATr3v5Z9aWRsfxCUQI0+
  64. lT5IAqzxyjlD5vexvd1+wytXVisDcqMDdjoZqbZmCL7cMBGerh1oWOD9AhiHqzTC
  65. x6/x44kAlQIFEC6wfvMNJrWMu42XwQEBoBsD/0xFuFxRRBvd1d94oTbMyBYensOB
  66. 8iVPEE06W4Ai+CN4bUrwsEH0bossz51pXtekSA4BgpTWt9xthr0S2N1jQwNbcmBO
  67. G+rkA0hrhTafX1jRr55zNJk38eeCwJCmdGI5Z5xYLnzYe4hP5ToL1vTYQq+ZkMGZ
  68. eZxTE/MAT5rr/I1F
  69. =K1zN
  70. -----END PGP PUBLIC KEY BLOCK-----
  71.  
  72. ›1m Distribution ›0m
  73. DISTRIBUTION:
  74.  
  75. Virus_Checker is a SHAREWARE product as from version 6.40. If you use this
  76. software then please send a fee of US$20 to the author at the address below
  77.  
  78. You may upload it wherever you choose, but you are not allowed to sell
  79. Virus_Checker for profit, or include Virus_Checker on a disk which is sold
  80. for profit, without the author's (John Veldthuis) permission.  Commodore
  81. have this permission already.
  82.  
  83. Please send me any more new viruses so I can update Virus_Checker,
  84. but please don't send a letter asking for a copy without sending me
  85. money to cover postage and disks. I cannot afford to send everyone a disk
  86. out of my own pocket. If you send just a disk then don't be surprised if
  87. you never see it again.
  88.  
  89.     John Veldthuis
  90.     21 Ngatai Street
  91.     Manaia, Taranaki
  92.     New Zealand
  93.     Phone  +64-6-274-8409
  94.  
  95. Email addresses:
  96.  
  97.     FIDO 3:775/40.0
  98.     USENET johnv@tower.actrix.gen.nz
  99.  
  100.  
  101. ›1mUnpack Library›0m
  102.  
  103. As from version 6.45 Virus_Checker now supports ›3munpack.libray›0m.
  104. What this library does is enable ›3mREGISTERED›0m users to
  105.  check LHA archives without having to unpack them first.  Virus_Checker
  106. handles it all automatically through unpack.library.
  107.  
  108. To enable this feature you must first be ›3mregistered›0m
  109. and have a keyfile.  Next you must tell Virus_Checker where you wish it to
  110. unpack the files.  This must be a directory that has no other files in it
  111. because ›3munpack.library›0m will delete everything in the
  112. directory after each archive is checked.  Also it must have enough space to
  113. unpack all the files.  unpack.library must be in LIBS:  directory.  Select
  114. up Use UnPackLib and it should all be go.  If the Use UnpackLib gadget is
  115. ghosted then you are not a registered user.
  116.  
  117. The program LHA must be in your C: directory. It has been reported as long
  118. as it is in your path you are okay but if you have problems put it in C:
  119.  
  120. **** MAJOR WARNING (Please Read) *******
  121.  
  122. The directory name given above must have nothing in it. VC will create the
  123. directory if it does not exist. However unpack.library will DELETE
  124. EVERYTHING in this directory after each archive it unpacks.
  125.  
  126. ***YOU HAVE BEEN WARNED***
  127.  
  128.  
  129. ›1mXfdMaster Library›0m
  130.  
  131. As from version 6.52 Virus_Checker will support ›3mxfdmaster.libray›0m.
  132. This is a unpacker library that extra modules can be added on very easily.
  133. It will only work under WB2.04 or better.  Just enable it and it will use
  134. the library.
  135.  
  136. WARNING:  This option may slow down the scan that Virus_Checker does.  This
  137. is because it will first read in the file for xfdmaster.library to check
  138. then if it is not crunched by one of these, unpack.library will read the
  139. file in. Thus causing the file to be read twice.
  140.  
  141. ›1m about Safe Hex International ›0m
  142.  
  143. ABOUT SAFE HEX INTERNATIONAL
  144.  
  145. SAFE HEX INTERNATIONAL HAS MY PERMISSION TO DISTRIBUTE THIS PROGRAM IN THE
  146. ARCHIVE "THE NEW SUPERKILLERS" OR IN ANY FORM THEY WISH TO
  147.  
  148. If you know a virus programmer you can get a reward of $ 1000 for
  149. supplying his name and address.  The fact is that the law punishes data
  150. crime very severely.  (5 years in jail in most countries).
  151.  
  152. We are an international group with more than 500 members who have started
  153. trying to stop the spread of virus.  Let me give you some example:
  154.  
  155.  
  156.      1. Our motto is: "Safe Hex", who dares do anything else today?".
  157.      2. A virus bank containing more than 1800 Amiga and PC viruses for
  158.     supporting good shareware anti virus programs.
  159.      3. We help people to get money back lost by virus infection.
  160.      4. We write articles about virus problems for about 20 computer 
  161.     magazines worldwide.
  162.      5. We release the newest and the best virus killers around.
  163.      6. We have more than 35 PC and Amiga "Virus Centers" worldwide 
  164.     where you can get free virus help by phoning our "Hotline", and 
  165.     the newest killers translated in your own language at very 
  166.     little cost.
  167.  
  168. For more information contact:
  169.  
  170.      SAFE HEX INTERNATIONAL     (Please  send  2 "Coupon-Response 
  171.      Erik Loevendahl Soerensen     International" and a self addres-
  172.      Snaphanevej 10         sed  envelope, if you want infor-
  173.      DK-4720 Praestoe         mation about SHI by letter).
  174.      Denmark
  175.      Phone: + 45 55 99 25 12
  176.      Fax  : + 45 55 99 34 98
  177.  
  178.  
  179. ›1m     ShareWare     ›0m
  180.  
  181. As from version 6.40 Virus_Checker has gone from being a freely
  182. redistributable program into being a shareware one.
  183. The change was not made lightly but too many people are making money off
  184. VirusChecker except me. The ammount of money I get sent in decides on if I
  185. continue to update the program or not.
  186.  
  187. Therefore if you use this program then please send a fee of US$20 to the
  188. address given here
  189.  
  190.     John Veldthuis
  191.     21 Ngatai Street
  192.     Manaia, Taranaki
  193.     New Zealand
  194.     Phone  +64-6-274-8409
  195.  
  196. ›1m     BrainFile     ›0m
  197.  
  198. BRAINFILE
  199.  
  200. As from version 6.40 Virus_Checker is able to use a brain file so that
  201. complete program updates are not required all the time. The file will need
  202. to go either in the current directory where VirusChecker is run from or the
  203. best place is L:.
  204. The name of the brainfile is VirusChecker.brain.
  205.  
  206. Put the file VirusChecker.brain in the L: directory and VC will use it
  207. The file is Checksum'ed and will warn you if it has been altered
  208. There is a version string imbedded in the file so that you can identify it.
  209.  
  210. ›1m Bootblock.Library ›0m
  211.  
  212. BOOTBLOCK.LIBRARY
  213.  
  214. As from version 6.29, Virus_Checker can use the SHI Bootblock.library by
  215.  
  216.              Johan Eliasson             Phone: +46 11 169138
  217.              Bäckgatan 6
  218.              60358 Norrköping
  219.              SWEDEN
  220.  
  221. What this does is add a brainfile of Bootblock viruses to Virus_Checker.
  222. You can update this file as SHI release new brainfiles. This way you can
  223. update Virus_Checker to recognize new BootBlock viruses without getting a
  224. new program.
  225. The file BootBlock.brainfile has to go in the L: directory and the
  226. Bootblock.library file in the LIBS: directory. The Install script will put
  227. it there automatically.
  228.  
  229.  
  230. ›1m Installation ›0m
  231.  
  232. INSTALLATION:
  233.  
  234. To run Virus_Checker once, either type it's name into a CLI window (while
  235. the program is in the current directory), or double-click on it's icon
  236. from the Workbench.  The program will be active until you quit it or reset
  237. your computer.
  238. Installing Virus_Checker so that it will be active all the while your
  239. computer is running is a good idea.  This is because viruses can be on any
  240. disk you insert into any disk drive.  With Virus_Checker always active,
  241. you will be protected.
  242.  
  243.           ›3m THE WORKBENCH STARTUP                           ›0m
  244.           ›3m WORKBENCH 1.3 USERS INSTALL                     ›0m
  245.           ›3m WORKBENCH 2.xx USERS INSTALL                    ›0m
  246.           ›3m VIRUS_CHECKER OPERATION                         ›0m
  247.               ›3m THE AREXX INTERFACE                             ›0m
  248.               ›3m THE USE OF THE BOOTBLOCK.LIBRARY                ›0m
  249.               ›3m NOTICE FOR USERS OF FILE PACKERS AND CRUNCHERS: ›0m
  250. ›1m WorkBench 1.3 install ›0m
  251.  
  252. WorkBench 1.3 install
  253.  
  254. Under 1.3, to install Virus_Checker so that it will be run whenever
  255. you reset your computer, edit your startup-sequence to include simply
  256. "Virus_Checker".  The program will have to be either in the root
  257. directory of the disk you are booting off of, or in the C: directory,
  258. for this to work.
  259.  
  260.   ›3m COMMAND LINE OPTIONS ›0m
  261.  
  262. ›1m WorkBench 2.xx install ›0m
  263.  
  264. WorkBench 2.xx install
  265.  
  266. Under the 2.0 operating system, installation is much easier.  All you
  267. have to do is drag the icon for Virus_Checker into the WBStartup
  268. drawer on your Workbench disk (or your boot partition if you use a
  269. hard disk), and Virus_Checker will automatically be loaded when the
  270. Workbench is loaded.
  271. If you don't load or use WorkBench then edit the user-startup file in the
  272. s: directory and simply include "Virus_Checker" somewhere in it.
  273.  
  274.                   ›3m COMMAND LINE OPTIONS           ›0m
  275.                   ›3m THE WORKBENCH STARTUP          ›0m
  276.                   ›3m THE 2.0 USER INTERFACE         ›0m
  277.  
  278. ›1m NOTICE FOR USERS OF FILE PACKERS AND CRUNCHERS: ›0m
  279.  
  280. NOTICE FOR USERS OF FILE PACKERS AND CRUNCHERS:
  281.  
  282. If you use a program such as PowerPacker to make your files smaller
  283. then be aware that you must check these files before you crunch them.
  284. If the file is infected and you crunch them then VC will not find the
  285. virus in the file unless you have the crunched checking option turned on
  286.  
  287.  
  288. ›1m Command Line Options ›0m
  289.  
  290. COMMAND LINE OPTIONS:
  291.  
  292. The syntax is:
  293.  
  294. Virus_Checker [-l###] [-t###] [-w###] [-b] [-q] [-i] [-n] [-m] 
  295.        -c# [dirname]
  296.  
  297. Where:
  298.  
  299.     -l### tells Virus_Checker how far from the left edge of the
  300.           screen to open the Virus_Checker window.
  301.  
  302.     -t### tells Virus_Checker how far down from the top edge of 
  303.           the screen to open the Virus_Checker window.
  304.  
  305.     -w### tells Virus_Checker how wide you want the window. It has 
  306.           a maximum size of 386 pixels and a minimum of 200.  Any 
  307.           numbers out of this range are ignored.
  308.  
  309.           This is ignored by Workbench 2.0 as there is really no need
  310.           for it due to being able to 'pop' the window up when you
  311.           want it and hide it when you don't want it.
  312.  
  313.     -b    tells Virus_Checker to send its window to the back of all
  314.           the other open windows.
  315.  
  316.     -n tells Virus_Checker not to open a window. It will check memory 
  317.           and disks inserted but you will have to use the ARexx port 
  318.           or the commodities 'Exchange' program (or the hotkey) to 
  319.           get it to scan the whole disk for Link/File viruses or to
  320.           view the user interface.  To stop VC, run VC again,  use 
  321.           the ARexx port, or send it a Kill command from the
  322.           commodities 'Exchange' program.
  323.  
  324.     -q tells Virus_Checker to check all memory, files, and disks for 
  325.           viruses, then exit.  To check the dh0: partition and exit,
  326.           do the following:  "Virus_Checker -q dh0:".  This will check 
  327.           memory, disks, files, and dh0:, then exit.
  328.  
  329.     -i tells Virus_Checker not to put up a requester when it can't read
  330.           the bootblock of a disk.
  331.  
  332.     -m tells Virus_Checker to watch the file s:startup-sequence for any
  333.           changes. Some viruses will change this file and VC will
  334.           catch it. (Only works under WB2.0 and above)
  335.  
  336.     -c# where # is 0 or 1
  337.         If -c0 is used then checking inside crunched files is turned off
  338.         if -c1 is used the the checking is turned on.
  339.  
  340.     dirname is the directory/file you want checked for File Viruses on 
  341.             startup.  An example to open the window at x/y position of 
  342.             200/100 and check DH0: is: "Virus_Checker -l200 -t100 dh0:".
  343.  
  344. Virus_Checker l 10 top 20 b i dh0:test
  345. This will set the VC window at x/y position of 10,20, make it into a
  346. backdrop window, ignore errors from the BootBlock reads and check the file
  347. dh0:test when it starts up.
  348.  
  349. For the window coordinates, any values outside the size of the WB
  350. screen are ignored and any non numerical values are ignored. There
  351. must be no spaces between the options and the numbers. Options may be
  352. given in any order.
  353.  
  354. If Virus_Checker is already running, and you invoke it again from the
  355. command line, it will pop open the already running version.
  356.  
  357. ›1m Command Line Options ›0m
  358.  
  359. For WB2.0 users the command line is
  360.  
  361. L=LEFT T=TOP B=BACKDROPWINDOW N=NOWINDOW Q=QUIT I=IGNOREBB W=WATCHSS
  362.   CHECKCRUNCHEDON CHECKCRUNCHEDOFF K=KILL S=STDOUT IGNORECAPTURE 
  363.   BBLIB DIR
  364.  
  365. L=LEFT is tells Virus_Checker how far from the left edge of the screen to
  366.       open the Virus_Checker window.
  367.  
  368. T=TOP tells Virus_Checker how far down from the top edge of the screen to
  369.      open the Virus_Checker window.
  370.  
  371. B=BACKDROPWINDOW sets the Virus_Checker window as a Backdrop window
  372.  
  373. N=NOWINDOW Virus_Checker not to open a window.  It will check memory and
  374.      disks inserted but you will have to use the ARexx port or the
  375.      commodities 'Exchange' program (or the hotkey) to get it to scan the
  376.      whole disk for Link/File viruses or to view the user interface.  To
  377.      stop VC, run VC again, use the ARexx port, or send it a Kill command
  378.      from the commodities 'Exchange' program.
  379.  
  380. I=IGNOREBB tells Virus_Checker not to put up a requester when it can't read
  381.      the bootblock of a disk.
  382.  
  383. W=WATCHSS tells Virus_Checker to watch the file s:startup-sequence for any
  384.      changes.  Some viruses will change this file and VC will catch it.
  385.  
  386. CHECKCRUNCHEDON turns on xfdmaster.library
  387.  
  388. CHECKCRUNCHEDOFF turns off xfdmaster.library
  389.  
  390. K=KILL will delete files with LINK viruses in them and not try to remove it
  391.  
  392. Q=QUIT tells Virus_Checker to check all memory, files, and disks for
  393.      viruses, then exit.  To check the dh0:  partition and exit, do the
  394.      following:  "Virus_Checker QUIT dh0:".  This will check memory, disks,
  395.      files, and dh0:, then exit.
  396.  
  397. S=STDOUT  This is a special mode for Virus_Checker. It implies that
  398. Virus_Checker will quit as soon as it finishes it's checks, Will not put up
  399. any requesters, opens no window, and if it finds any virii it will not
  400. delete them but will write the name of the file and virus to the shell from
  401. which it started. This can be used by BBS operators to check archives
  402. automatically. a line like
  403. Virus_Checker >ram:infected STDOUT DH0:
  404. would check all files in DH0: and if it found any would write the results
  405. to a file called ram:infected.
  406.  
  407. IGNORECAPTURE tells Virus_Checker to ignore the initial check on the
  408. capture vectors. It will still warn you of changes while it is running.
  409.  
  410. BBLIB This tells Virus_Checker to use the SHI BootBlock.library. This
  411. should be used as any viruses detected by this library will not be added to
  412. the normal Virus_Checker checking. You need BootBlock.library in the LIBS:
  413. directory and BootBlock.brainfile in L:
  414.  
  415. DIR is the name of a dir/file to check for viruses on startup
  416.  
  417. ›1m THE WORKBENCH STARTUP ›0m
  418.  
  419. THE WORKBENCH STARTUP:
  420.  
  421. SPECIAL NOTE:
  422.  
  423. If Virus_Checker is not run from Workbench it will look for the file
  424. S:VIRUS_CHECKER.INFO  This is just a standard workbench info file and can
  425. be used as described in the next section. This is to allow 1.3 users who
  426. run VC from their startup-sequence to config VC easily. It will work for
  427. 2.0 users as well. I have done it this way because it is too hard to find
  428. where a program ran from under 1.3. This way I only have to look for 1 file
  429. in one directory.
  430. To use it add the stuff you want under Workbench and save it. Then copy the
  431. Virus_Checker.info file to the S: directory.
  432.  
  433. Support for the icon stuff has now been put in. These will override the
  434. default settings and also the settings in the S:Virus_Checker.config file.
  435. It will only affect those things that are given in the ICON. The rest will
  436. be left as default or as the config file sets them.
  437.  
  438. The things that you can put in via the Information menu on Workbench are as
  439. follows. These will be used if VC is started by Workbench
  440. HOTKEY is only used by WB2.0
  441.  
  442.  
  443. HOTKEY=string           /* HOTKEY=lcommand shift del                  */
  444. LEFT=num                /* LEFT=150                                   */
  445. TOP=num                 /* TOP=25                                     */
  446. WINDOW=ON/OFF           /* WINDOW=ON or WINDOW=OFF                    */
  447. RESIDENT=ON/OFF         /* RESIDENT=ON or RESIDENT=OFF                */
  448. IGNOREBBERROR=ON/OFF    /* Ignore BootBlock Read Error                */
  449.                         /* use IGNOREBBERROR=OFF to turn requester off*/
  450. WATCHSS=ON/OFF          /* WATCHSS=ON or WATCHSS=OFF                  */
  451. CHECKCRUNCH=ON/OFF      /* Turn on/off Crunched file checking         */
  452. DF0=ON/OFF              /* DF0=ON or DF0=OFF                          */
  453.  |
  454.  V                ;If Off VC will not check BootBlock or startup-sequence
  455. DF3=ON/OFF
  456. FULLCHECKDF0=ON/OFF     /* FULLCHECKDF0=ON or FULLCHECKDF0=OFF        */
  457.      |
  458.      V                ;If ON VC will scan all files on the inserted disk.
  459. FULLCHECKDF3=ON/OFF
  460. CHECKCRUNCHED=ON/OFF    /* Tells VC to use/not use  xfdmaster.library */
  461. BBLIB=ON        /* Tells VC to use BootBlock.library          */
  462.  
  463.  
  464. IN ALL CASES DO NOT USE THE QUOTE MARKS " or ' in any place. VC can see the
  465. spaces between strings without them.
  466.  
  467. ›1m The ARexx Interface ›0m
  468.  
  469. THE AREXX INTERFACE:
  470.  
  471. VC has an ARexx port, which means you can send VC commands using the
  472. REXX language, available from your Amiga dealer, or as part of the 2.0
  473. Operating System.  The port name is "Virus_Checker". Be aware that
  474. case is important and ARexx will not find it if the name is not spelled
  475. right.  Here is an example ARexx program that talks to VC:
  476.  
  477.         /* ARexx programs must start with a comment */
  478.  
  479.         address 'Virus_Checker'    /* Talk to Virus_Checker                  */ 
  480.         'checkdrive\df0:'          /* Make virus_Checker check df0:         */
  481.                                    /* for viruses                          */ 
  482.         'scanforsaddam\df0:'       /* Make VC check df0: for Saddam         */
  483.                                    /* virus damage                        */
  484.         'quit'                           /* Make Virus_Checker shut down.        */
  485.         'drive\df1: off'           /* Turn off df1: from being scanned  */
  486.  
  487. Notice the '\' between the command and the drive name in the middle
  488. examples. This must be put between all commands and their options.  'quit'
  489. does not take an option so does not need the '\' character there.
  490. Virus_Checker will take the following commands:
  491.  
  492.         checkdrive\drivename      Check drive 'drivename' for file viruses.
  493.         scanforsaddam\drivename   Check drive (DF0:-DF3) for Saddam damage.
  494.         quit                      Make Virus_Checker shut down.
  495.         saveconfig                Save the s:Virus_Checker.file file
  496.         window\option             Open or Close window (Option = on or off)
  497.         drive\df?: option         Turn on/off Drive scan (Option = on or off)
  498.         resident\option           Turn on/off Resident flag ""      ""  ""
  499.         checkfile\device:dir/filename
  500.         checkbootblock\df?:       Check the Bootblock in df? for viruses
  501.         reloadbrain               Reload VirusChecker.brain file
  502.  
  503. Special note for 'checkfile' command.
  504. This one turns off any requesters while doing it's work. If the command
  505. OPTIONS RESULTS is used it will return RESULT if no virus found or if a
  506. virus is found then the string VIRUSNAME Virus was/is present in the file.
  507. This does not mean the virus is gone as there may have been errors trying
  508. to remove the virus.
  509. This is really for BBS users who want to check files as they come in.
  510. You could write an arexx script to search files and log any that come up
  511. with viruses. Later after finding which ones where infected you would run
  512. VC over them again via the main menu thus making sure they where clear.
  513.  
  514.      Changed Arexx CheckFile and CheckDir command.
  515.      For Checkfile RESULT will still be valid as before BUT now better
  516.      support. If VCHECK.0.0 <> 0 the there was a file infected.
  517.      VCHECK.x.1 will hold the file name and
  518.      VCHECK.x.2 will hold the Virus name
  519.      Here is how you can scan a disk using arexx.
  520.      /Small Arexx script */
  521.      options results
  522.      address 'Virus_Checker' 'checkdrive\DH0:
  523.      say VCHECK.0.0
  524.      if VCHECK.0.0 > 0 then do
  525.     do i = 1 to VCHECK.0.0
  526.        say VCHECK.i.1
  527.        say VCHECK.i.2
  528.     end
  529.      end
  530.      This can be used for BBS checks. Unpack the archive to a temp dir and
  531.      then run checkdir over that and check the results.
  532.  
  533. CheckBootBlock command
  534. This one also needs the options results and returns messages.
  535. If the disk is clear or you give it a number outside the range of df0: to
  536. df3: it will return 'Okay', if VC had trouble reading the disk the message
  537. returned is 'ERROR reading BOOTBLOCK', if the bootblock is Not the normal
  538. one then 'NON-STANDARD BOOT CODE' is returned.  If the Bootblock is
  539. infected then the virus name will be returned.  At present there is no way
  540. to clear the virus from Arexx but I am working on it.  Requesters are
  541. disabled while this is done.
  542.  
  543.  
  544. ›1mMakeKey program›0m
  545.  
  546. MAKEKEY
  547.  
  548. This is a specially written program to allow users who have registered to
  549. make a keyfile from the information they recieve.
  550. It can be run from SHELL or WORKBENCH and opens a GUI. It requires WB2.04
  551. or better to run.
  552. Enter the data into the gadgets and click on MakeKey and the keyfile will
  553. be generated.
  554.  
  555. WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
  556.  
  557. Do not click on MakeKey if you do not have the right information. Doing so
  558. will probably slow the system down greatly and may even appear to lock up
  559. the Virus_Checker program.
  560.  
  561.  
  562. ›1m Virus_Checker Operation ›0m
  563.  
  564. VIRUS_CHECKER OPERATION:
  565.  
  566.  Upon running Virus_Checker, it will first check your memory for
  567. viruses and tell you if any were detected.  They will either be
  568. removed or disabled.  Next all disks in the floppy drives will be
  569. checked.  Any disk put in any drive (df0: to df3:) will be checked.
  570.  
  571. If Virus_Checker finds and disables the LAMER virus in memory, the
  572. machine may guru.  Once the machine is reset, however, the virus
  573. should be gone.
  574.  
  575. ›1m The 2.0 User Interface ›0m
  576.  
  577. THE 2.0 USER INTERFACE:
  578.  
  579. Many Thanks goes to Steve Tibbett for designing and most of the C code for
  580. this section. All I did was translate it into assembly and intergrate it
  581. into Virus_Checker.
  582.  
  583. This section describes the user interface that Virus_Checker uses
  584. when Kickstart 2.0 is detected in your computer.  This section does
  585. not apply for users with Kickstart 1.3.
  586. Kickstart 1.3 users can see the special note for using the Config file
  587. below.
  588.  
  589. Virus_Checker can be used either with a window open, or with no window
  590. open.  When used with the window closed, Virus_Checker will only show
  591. itself when it has something to tell you about.  If you insert a disk
  592. containing a virus, Virus_Checker will pop up a requester telling you
  593. about it, and give you some options to deal with it.
  594.  
  595. The normal Virus_Checker user interface can present itself in two
  596. forms.  One is the 'TitleBar Window', where only the close gadget,
  597. the depth gadget, the Zoom gadget, and the program name are visible. 
  598.  
  599. If you click the Zoom gadget, Virus_Checker's window will change into
  600. a window occupying nearly half a normal 640x200 Workbench screen.
  601. This window is broken up into three sections:  The Preferences
  602. section, the Files section, and the Drives seection.
  603.  
  604. In the Preferences section, you can tell Virus_Checker whether it
  605. should open a window or not, whether the window should be a Backdrop
  606. window, and whether Virus_Checker should quit immediately when run,
  607. or whether it should stay resident.  You can also set the window
  608. position, and the hotkey that will call Virus_Checker when you want
  609. to open it's window or pop it to the front.  (The hotkey format is
  610. described in the AmigaDOS 2.0 manual, in the section on the
  611. commodities exchange). As from 6.05 you can also tell Virus_Checker to
  612. ignore errors when reading the BootBlock. It will be saved in the config
  613. file.
  614.  
  615. THE DEFAULT HOTKEY is Left-Amiga Shift del
  616.  
  617. The Files section is where you list the drives or directories that 
  618. Virus_Checker will check when you click the Check button.  If you 
  619. 'Add' DF0: and DF1: to the list, then choose Check, then
  620. Virus_Checker will check all the files on both DF0: and DF1: for file
  621. viruses.
  622.  
  623. The Drives section lets you specify which of your floppy disk drives
  624. will automatically be checked for bootblock and file viruses when you
  625. insert a disk. If you have a program like CrossDOS and you don't want
  626. Virus_Checker looking at the msdos disks then simply disable it and
  627. Virus_Checker will never look at that drive again. Unless you enable it
  628. again.
  629.  
  630. The Second row of Drive gadgets turn on and off the automatic scanning of
  631. the entire disk. These are disabled by default. If you turn them on, then
  632. Virus_Checker will scan the entire disk every time you insert one.
  633. Checking for file viruses takes some time, so you may not want this on for
  634. a drive that you are constantly moving disks in and out of.
  635. The state of these gadgets is also saved in the Config file.
  636.  
  637. Any of the Gadgets that have text with an UnderScore beneath then can be
  638. accessed by simply pressing the that key on the keyboard.
  639. For example. If you wished to change the Hotkey you will notice that the H
  640. in HotKey is Underlined. This means simply by pressing the 'h' key that
  641. gadget will become active.
  642.  
  643. The options that you set in the user interface can be saved to disk
  644. using the Save button.  The options are saved to the file
  645. "S:Virus_Checker.Config", and are read from there whenever the
  646. program is loaded.
  647.  
  648. KEYSTROKES:
  649.  
  650. The Following keys will activate the following functions, when typed
  651. into the Virus_Checker window:
  652.  
  653. s -    Will activate the Scan mode
  654. m -    Will immediately do a complete memory scan (same as startup)
  655. f -    Will activate the Saddam Disk Scan (used to fix Saddam virus damage)
  656. 0 - 3  Will check the First File in startup-sequence and bootblock on disk
  657.        in drive which matches number
  658.  
  659. There are also some options on the menu (hold the right mouse button
  660. to get to the menus) which have keyboard-equivalent shortcuts.  These
  661. are next to the inverse A on the menu.
  662.  
  663. LINK/FILE VIRUS CHECK:
  664.  
  665. If you want to check a disk for Link/File viruses then put the disk in
  666. any drive. Make sure the Virus_Checker window is active and use the right
  667. mouse button to bring up the Project Menu. Select the "Link/File Scan"
  668. and release the mouse button.  An alternative way is to just press
  669. the 's' key on the keyboard.
  670.  
  671. This will bring up a requester asking you which drive to check. Enter
  672. the drive name in the box, eg.  DF0:, DH1:,RAD:  etc. Under WB2.0 you
  673. can also use the "Use Requester" option.  It will then check all the
  674. files on that drive.  You can also enter directories if you want to
  675. eg, c:  df0:c, df0:libs etc.
  676.  
  677. When Virus_Checker is scanning the disk and you know that a directory
  678. is clear and don't want to check it press control-d in the window
  679. with the filenames and Virus_Checker will ignore that directory and
  680. go back up one level.
  681.  
  682. If you want to stop the check completely press control-c in the
  683. window with the filenames and Virus_Checker will print a break
  684. message then stop scanning the disk and go back to normal scanning.
  685.  
  686. If Virus_Checker brings a requester up that says a program just run
  687. has infected your memory with the Xeno Virus, it has already disabled
  688. it.  You should immediately check all files on the disks that are in
  689. the drives at that time.  This means that a program that you just ran
  690. or a program some other program just ran is infected with the virus
  691. and all files should be checked to find out which one it was.
  692.  
  693. With viruses which use a RomTag I have decided to clear out all
  694. RomTags to make sure I remove the Viruses from the list.  In doing
  695. this you will lose things like Recoverable ram disks such as RAD:,
  696. VD0: etc. If you have a virus make sure that you save anything in the
  697. ram disks that you want before rebooting.  The ramdisks and others
  698. will disappear on a reboot.  My policy is better safe than sorry.
  699.  
  700. BRAINFILE ADDITION:
  701.  
  702. When VC finds a Non-Standard bootblock it will bring up 4 gadgets.
  703. One of these gadgets is Learn.  Pressing this will allow VC to
  704. remember this BootBlock and not bother you again with it.  To do this
  705. VC writes a file called VCBrainFile to the S: directory.  If you have
  706. a single drive this will invoke a requester asking that Volume
  707. something be put in the drive.  This will then save to the file.  On
  708. Startup VC will check for the file in the S: directory and read it if
  709. it is there.  If not it will carry on without it.  If you get an error
  710. then VC will tell you about it and will happily write over the file
  711. next time.
  712.  
  713.  
  714.  
  715. NON-STANDARD BOOT CODE:
  716.  
  717. When Virus_Checker brings up a Requester that says the disk has
  718. non-standard boot code, this means that the code in the boot block is
  719. not what should be there.  This does not mean that it is a virus as
  720. many games use copy protection in their boot blocks, and there are many
  721. bootblocks that do interesting things, that are not viruses.  You
  722. should however be cautious if it is not a game.  Do not replace the
  723. boot block if you are not sure.  If something strange happens then
  724. please send a copy of the disk to me so that I can check it out.  To
  725. determine if an unknown bootblock is likely a virus:
  726.  
  727. 1.      Format a blank disk so you know it is clear.
  728. 2.      Make sure all disks except the one just formatted are write protected.
  729. 3.      Boot from the disk that you suspect.
  730. 4.      Place formatted disk in drive zero and then reboot.
  731. 5.      Take disk out of drive zero and turn off computer for about 30 secs.
  732. 6.      Run the Virus_Checker program. If the Virus_Checker finds
  733.         non-standard boot code on the newly formatted disk, you have found a
  734.         new virus.  Please send it to me.
  735.  
  736. ›1m Credits ›0m
  737.  
  738. CREDITS:
  739.  
  740. My thanks go out to...
  741.  
  742.  Steve Tibbett  For designing and most of the C code for the 2.0 User
  743.                 Interface on Virus_Checker.
  744.  
  745.  Thomas Neumann For the inclusion of unpack.library and His help on a bug 
  746.  
  747.  Georg Hörmann  For the inclusion of xfdmaster.library.
  748.  
  749.  Tim Nugent     For the conversion of this doc file to AmigaGuide format.
  750.  
  751.  ARexx          Developed on an Amiga 1000 and is a 100% Amiga product.
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.                                                     John Veldthuis.
  759. 6.44 Released 28 October 1994
  760.      Changed Arexx CheckFile and CheckDir command.
  761.      For Checkfile RESULT will still be valid as before BUT now better
  762.      support. If VCHECK.0.0 <> 0 the there was a file infected.
  763.      VCHECK.x.1 will hold the file name and
  764.      VCHECK.x.2 will hold the Virus name
  765.      Here is how you can scan a disk using arexx.
  766.      /* Small Arexx script */
  767.      options results
  768.      address 'Virus_Checker' 'checkdrive\DH0:
  769.      if VCHECK.0.0 > 0 then do
  770.     do i = 1 to VCHECK.0.0
  771.        say VCHECK.i.1
  772.        say VCHECK.i.2
  773.     end
  774.      end
  775.      This can be used for BBS checks. Unpack the archive to a temp dir and
  776.      then run checkdir over that and check the results.
  777. 6.45 Released 3 December 1994
  778.      Added unpack.library for use with registered versions. This allows the
  779.      use of unpack.library to check LHA/LZH archives without having to
  780.      unpack them first
  781.      Added Polyzygotronifikator virus. Tricky little beast. VC does not
  782.      remove the virus code but disables it.
  783.      There was a keyfile generator in Germany for VC. Due to this I changed
  784.      format and as such those who used it are wasting their time and mine.
  785.      This cost me $200 in postage alone to send out new keyfiles to
  786.      everyone. I hope the mongrel is happy now. BTW there is fingerprint in
  787.      the key it generated  and stand by for a surprise for those who used
  788.      it.
  789. 6.46 Released 31 December 1994
  790.      Added KEYPATH variable. If running under WB2.04 or better VC will use
  791.      the enviroment variable KEYPATH to look for it's keyfile.
  792.      Changed code so that Polyzygotronifikator is now completely removed
  793.      Small bug with Commander virus. Did not allocate a big enough buffer
  794.      Checking in LHA files worked but not main scan.
  795. 6.47 Released 31 December 1994
  796.      Bloody assembler did brain in again. New Release
  797.  
  798. 6.50 Released 22 January 1995
  799.  
  800. Added updated BootBlock.brainfile
  801. Major change to way scanning code works. No longer uses decrunch.library,
  802. instead uses unpack.library. Key still required for LHA files though.
  803. If virus found in file that has been crunched and it is a link virus then
  804. VC will remove the virus and save the file out as uncrunched.
  805.  
  806. 6.51 Released 7 January 1995
  807.  
  808. There has been a problem with some machines crashing for unknown reasons
  809. and it was not easy to find the problem. Someone finally sent me a file in
  810. that caused VC to lockup. The problem is with unpack.library and it was
  811. getting stuffed up by a file. I will send it on to the author of
  812. unpack.library and hopefully it will be fixed. This release should fix the
  813. problem in the meantime (hoefully)
  814.  
  815. 6.52 Released 26 Febuary 1995
  816.  
  817. Fixed bug with crashing when unpack.library was not available or wrong
  818. version.
  819. Added xfdmaster.library to checker. If enabled then uncrunches files using
  820. xfdmaster.library. WARNING this option can slow do the scan as the file has
  821. to be read twice at times.
  822. There is still a problem with unpack.library crashing on files packed with
  823. PowerPacker 2.3 Master. Turning on XFD will cure the problem in the short
  824. time.
  825.  
  826. ************************************************************************
  827.  
  828.